home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / Music / MISC / MusicalDiceGame / MusicalDiceGame.doc < prev    next >
Text File  |  1995-08-23  |  8KB  |  272 lines
  1.             +-------------------------------------------------+
  2.             |                                                 |
  3.             |       M   s i          D             a          |
  4.             |         u     c   l      i         G    m       |
  5.             |                 a          c e           e      |
  6.             |                                                 |
  7.             |                                                 |
  8.             |                                                 |
  9.             |     v1.0   Copyright © 1994  De Biasi Marzio    |
  10.             +-------------------------------------------------+
  11.  
  12.  
  13.  
  14.  
  15. [0] Index:
  16. ----------
  17.   [0] These :-) lines 
  18.   [1] What is Musical Dice Game?
  19.   [2] MusicalDiceGame program
  20.   [3] CLIDice and DiceCommand programs
  21.   [4] Infos 'n' Copyrights
  22.   [5] Disclaimer
  23.   [6] Short history
  24.  
  25.  
  26.  
  27.  
  28. [1] What's Musical Dice Game?
  29. -----------------------------
  30.  
  31.   The musical dice game (Musikalisches Wuerfelspiel) was created by 
  32.   Wolfgang Amadeus Mozart in 1791; it allows you to create "random" Waltzes.
  33.  
  34.   The game requires the following: two dice, two number tables (each one with 
  35.   8 columns and 11 rows), and a note section with 176 individual waltz
  36.   measures.
  37.   The eight columns of both number tables represent the eight measures of
  38.   both waltz sections, the row numbers (2-12) give the possible outcomes
  39.   with two dice and the cell numbers give the numbers of the waltz
  40.   measures.
  41.  
  42.   The game begins: if, for example, the first toss yelds a 10 then you
  43.   search in the first column at row number 10 for the number of the measure:
  44.   that's the first measure of your waltz.
  45.   Then you toss for the second measure; if you obtain, for example, a 7,
  46.   then you find the number of the second measure in the second column at
  47.   row number 7. And so on.
  48.  
  49. >>>>  Now you can turn on your Amiga and throw away the dice, the tables
  50.       and the measures ... ;-D
  51.  
  52.   
  53.  
  54.  
  55. [2] MusicalDiceGame program
  56. ---------------------------
  57.  
  58.   To start MusicalDiceGame program simply double-click on its icon (a 
  59.   GREAT icon!).
  60.   In the control window you find the following buttons:
  61.  
  62.  
  63.     BUTTON                FUNCTION
  64.     ~~~~~~            ~~~~~~~~
  65.  
  66.     +------+
  67.     | PLAY |        : start playing the current waltz
  68.     +------+          from first measure
  69.     
  70.     +------+
  71.     | STOP |        : stop playing the current waltz
  72.     +------+
  73.  
  74.     +----------+
  75.     | CONTINUE |        : continue playing the current waltz
  76.     +----------+          from last measure played before stop
  77.  
  78.     +-----+
  79.     | NEW |            : discard the current waltz
  80.     +-----+              and compose a new waltz
  81.  
  82.     +------+
  83.     | QUIT |        : quit MusicalDiceGame
  84.     +------+
  85.  
  86.  
  87.   It's very easy, isn't it?
  88.  
  89.  
  90.  
  91.  
  92. [3] CLIDice and DiceCommand programs
  93. ------------------------------------
  94.  
  95.   In the archive you find another two programs:
  96.  
  97.     * CLIDice      : a CLI version (no GUI) of the MusicalDiceGame
  98.       -------
  99.  
  100.     * DiceCommand : a program to send commands to the CLIDice program 
  101.       -----------
  102.  
  103.  
  104.   If, for example, you want to play a nice waltz during the execution
  105.   of the user-startup, insert the CLIDice command at it's top, and the
  106.   DiceCommand quit command at it's bottom:
  107.  
  108.  
  109.     CLIDice
  110.     ............................
  111.  
  112.     .... your startup stuff ....
  113.  
  114.     ............................
  115.  
  116.     DiceCommand quit
  117.  
  118.  
  119.  
  120.  
  121.   Here it is the syntax of the two commands:
  122.  
  123.  
  124.   (a)  CLIDice    [-q]
  125.     
  126.  
  127.     If you specify -q option, CLIDice will not start playing immediately
  128.     (it will wait for a 'DiceCommand play' ).
  129.     *** CLIDice will stay in memory until it receives a quit command from
  130.     DiceCommand.
  131.     *** CLIDice DOESN'T EAT CPU TIME when it's not playing, and when
  132.     it is playing eats very few cpu time!!!
  133.  
  134.  
  135.  
  136.  
  137.   (b)  DiceCommand <command>
  138.  
  139.  
  140.     where <command> is one of the following
  141.  
  142.     play            : start playing the current waltz
  143.     stop            : stop playing the current waltz
  144.     continue        : resume playing the current waltz
  145.     new            : compose a new waltz
  146.     quit            : QUIT CLIDice PROGRAM
  147.  
  148.  
  149.  
  150.   For programmers:
  151.  
  152.   If you want to build your own CLIDice driver (if, for example, you want
  153.   to write a screen blanker that uses CLIDice), then you can find the
  154.   simple DiceCommand source code in directory Programmers.
  155.  
  156.   Communications between CLIDice and DiceCommand are made using a
  157.   simple message port; DiceCommand has not a reply message port, but 
  158.   CLIDice checks if the messages it receives contain a non-NULL pointer
  159.   to a reply message port and, if necessary, calls ReplyMsg() function.
  160.  
  161.  
  162.  
  163.  
  164. [4] Infos 'n' Copyrights
  165. ------------------------
  166.  
  167.   System requirements
  168.   ~~~~~~~~~~~~~~~~~~~
  169.   Every Amiga with OS 2.0 or higher.
  170.  
  171.  
  172.   Contents
  173.   ~~~~~~~~
  174.  
  175.   MusicalDiceGame (v1.0) comes in the lharc archive MusicalDiceGame.lha
  176.   which holds th following files:
  177.  
  178.   MusicalDiceGame        > GUI version of musical dice game
  179.   MusicalDiceGame.info        > a great MagicWB icon for MusicalDiceGame
  180.   MusicalDiceGame.doc        > this documentation
  181.   CLI/CLIDice            > a CLI version (no GUI) of m.d.g.
  182.   CLI/DiceCommand        > CLI command to control CLIDice
  183.   Programmers/DiceCommand.c    > DiceCommand C source code
  184.  
  185.   plus some other .info files
  186.  
  187.  
  188.   Copyrights
  189.   ~~~~~~~~~~
  190.  
  191.   MusicalDiceGame is FREEWARE: the archive MusicalDiceGame.lha MAY BE
  192.   FREELY DISTRIBUTED, as long as no charges more than reasonable copying
  193.   and handling fees are collected!!!
  194.   You cannot modify (or leave out) none of its files, and, if you write
  195.   a FreeWare or ShareWare program that uses M.D.G., you must distribute
  196.   the (original) M.D.G. package with your program.
  197.  
  198. * This program may be included in freeware collections, providing that the
  199.   previous conditions are respected.
  200.  
  201. * TO SOFTWARE REVIEWS: if you include this program in one of your
  202.   disks, please send me a copy of the review, thanks :-)
  203.  
  204.  
  205.   Bugs & remarks
  206.   ~~~~~~~~~~~~~~
  207.  
  208.   If you find some bUGS or you want to give me some ideas or remarks
  209.   you can send me an email (see below for the Internet address).
  210.  
  211.  
  212.   Source code
  213.   ~~~~~~~~~~~
  214.   
  215.   If you want the MusicalDiceGame source code and the original tables,
  216.   please send me $10 (US).
  217.  
  218.   My address:
  219.  
  220.             +--------------------------------------+
  221.             |                                      |
  222.             |     De Biasi Marzio                  |
  223.             |     via Borgo Simoi, 34              |
  224.             |     31029 Vittorio Veneto (TV)       |
  225.             |     Italy                            |
  226.             |                                      |
  227.             |     E-Mail: debiasi@dimi.uniud.it    |
  228.             |                                      |
  229.             +--------------------------------------+
  230.   
  231.  
  232.  
  233.  
  234. [5] Disclaimer
  235. --------------
  236.  
  237.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  238. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  239. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  240. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  241. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  242. PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  243. PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  244. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  245.  
  246.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  247. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  248. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  249. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  250. USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  251. OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  252. THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  253. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  254. POSSIBILITY OF SUCH DAMAGES.
  255.  
  256.  
  257.  
  258.  
  259. [6] Short history
  260. -----------------
  261.  
  262.   During the developement of MusicalDiceGame program I've used:
  263.  
  264.      GadToolsBox (2.0b)    Copyright © by Jan van den Baard
  265.  
  266.     OctaMED v2.0        Copyright © by Teijo Kinnunen
  267.  
  268.     MagicWB 1.2p        Copyright © by Martin Huttenloher
  269.  
  270.   Thank you very much! ;-)
  271.  
  272.